home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILFILE / ZDIR100.LZH / ZDIR.DOC < prev    next >
Text File  |  1988-10-10  |  39KB  |  1,160 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.          
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                             Zippy DIR - Version 1.00
  24.                           Copyright (c) 1988, Ray Johns
  25.  
  26.                               ALL Rights Reserved.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                   - Contents -
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                   Disclaimer . . . . . . . . . . . . . . . .  1
  78.                                                                
  79.                   Features of ZDIR . . . . . . . . . . . . .  2
  80.  
  81.                   Who is Ray Johns ? . . . . . . . . . . . .  3
  82.                                                                
  83.                   Registration information . . . . . . . . .  4 
  84.                                                                
  85.                   Why another DIR replacement ?  . . . . . .  5
  86.                                                                
  87.                   Installation . . . . . . . . . . . . . . .  6 
  88.                                                                
  89.                   Command line format  . . . . . . . . . . .  7,8,9
  90.                                                                
  91.                   Function keys  . . . . . . . . . . . . . .  10,11
  92.                                                                
  93.                   The display  . . . . . . . . . . . . . . .  12
  94.  
  95.                   Future plans for ZDIR  . . . . . . . . . .  13
  96.                                                                
  97.                   Contacting me about ZDIR . . . . . . . . .  14
  98.                                                                
  99.                   Customizing ZDIR . . . . . . . . . . . . .  15
  100.  
  101.                   Miscellaneous notes  . . . . . . . . . . .  16
  102.  
  103.                   Revision history & Acknowledgments . . . .  17
  104.                                                          
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                  - Disclaimer -                                       
  128.  
  129.  
  130.              Although Zippy DIR Version 1.00 has been extensively tested, 
  131.         you  use it at your own risk.   I,  Ray Johns,  shall not be held 
  132.         liable in any way, for any damages which may result from the use, 
  133.         or  misuse,  of this or any program which I have  written.   This 
  134.         program is delivered in an "as is" condition.  
  135.  
  136.              Note  that Zippy DIR does not write to the disk in  any  way 
  137.         and  uses  only  the most standard DOS  function  calls.   To  be 
  138.         absolutely  sure you have a valid copy of this program,  you  are 
  139.         welcome  to call any one of the "distribution BBS numbers" listed 
  140.         later in this document to obtain a fresh or updated copy.
  141.  
  142.              Zippy  DIR will run on any IBM or compatible computer  using 
  143.         MS/PC DOS version 2.00 or greater.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                         1
  184.  
  185.  
  186.  
  187.  
  188.                               - Features of ZDIR -
  189.  
  190.  
  191.              Zippy  DIR  supports  all standard  DOS  DIR  commands.   In 
  192.         addition it has many expanded features and options.  Following is 
  193.         a brief list of this features :
  194.  
  195.  
  196.         o   All displayed numbers have commas for easy reading.
  197.  
  198.         o   All directories include system and hidden files.
  199.  
  200.         o   File attributes are included in display.
  201.  
  202.         o   File date and time stamps are in easy to read formats.
  203.  
  204.         o   Volume  name  of  any  disk is  displayed  in  the  root 
  205.             directory where it is actually stored by DOS.
  206.  
  207.         o   Wide and normal display modes are supported.
  208.  
  209.         o   Display  can  be  paused automatically after  each  full 
  210.             screen of information.
  211.  
  212.         o   Display  can  be easily controlled  via  function  keys.  
  213.             Display  controls include : Single  step,  pause/resume, 
  214.             search, mode toggle, display restart, and terminate.
  215.  
  216.         o   Display  can  be  limited to  only  executable,  or  non 
  217.             executable files.
  218.  
  219.         o   Normal and reverse wild cards are supported in filename.
  220.  
  221.         o   First letter searching is supported on filename.
  222.  
  223.         o   Text string searches are supported within filename.
  224.  
  225.         o   Bytes  used by matching files as well as bytes remaining 
  226.             on drive are displayed.
  227.  
  228.         o   Printer echoing and file routing is supported.
  229.  
  230.         o   Internal help is available.
  231.  
  232.         o   Standard ERRORLEVEL codes returned after execution for 
  233.             compatibility with .BAT files.
  234.  
  235.         o   Program is written in 100% assembly language for maximum 
  236.             speed and minimum size.
  237.  
  238.         o   User patchable bytes within program.
  239.  
  240.         o   Requires MS/PC DOS Version 2.00 or greater.
  241.  
  242.  
  243.  
  244.                                         2
  245.  
  246.  
  247.  
  248.  
  249.                              - Who is Ray Johns ? -
  250.  
  251.  
  252.              You may be familiar with my first Shareware program released 
  253.         earlier this year.   A little program to check your disk's  space 
  254.         allocation.   The name is DMD200.ARC and is copyrighted under the 
  255.         name of P.C. Consulting.
  256.  
  257.              I am attempting to make my mark on the Shareware world with, 
  258.         what  I believe,  are high quality,  easy to use programs.   I've 
  259.         been  writing  programs  and BBSing since  1980,  and  have  been 
  260.         writing  Shareware for IBM and compatible computers for a  number 
  261.         of months now.  Zippy DIR represents my second Shareware program.  
  262.         Starting with this program,  I will be releasing all my Shareware 
  263.         under my own name,  as opposed to P.C. Consulting, so that if you 
  264.         happen to see me on a BBS and you have a question about something 
  265.         I have written, you will know who "Ray Johns" is.
  266.  
  267.              All  my  Shareware  is written in  8088  Assembly  Language.  
  268.         There  are two reasons why I use this language.   One,  it is the 
  269.         fastest language available,  thus,  programs written in  assembly 
  270.         language run very quickly and very smoothly.  Two, the executable 
  271.         files are much smaller than those produced by other methods, like 
  272.         a  BASIC compiler for example,  this means faster program loading 
  273.         and less memory requirements.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.                                         3
  306.  
  307.  
  308.  
  309.  
  310.                           - Registration information -
  311.  
  312.  
  313.              This program is not Public Domain,  and it is not  Freeware, 
  314.         what  it is,  is Shareware.   As you probably already know,  what 
  315.         Shareware  means is this;  you are welcome to share this  program 
  316.         with others, as long as you follow a few simple rules.  
  317.  
  318.  
  319.         o   No  fee  is charged for this  program.   This  does  not 
  320.             include  fees  such as Shareware houses and pay for  use 
  321.             bulletin boards.
  322.  
  323.         o   Zippy DIR must not be modified or altered in any way.
  324.  
  325.         o   All files,  READ-ME.1ST,  ZDIR.COM,  ZDIR.DOC, ZDIR.MSG, 
  326.             and  ZDIR.REG MUST be distributed as a  package.   These 
  327.             files  must not be modified and must have all  copyright 
  328.             notices  in  place.  Whenever  possible  distribute  the 
  329.             ZDIR100.ARC file, and not the individual files.
  330.  
  331.  
  332.              Shareware also means you,  the user, can get software for no 
  333.         initial cost,  unlike commercial software,  and review it at your 
  334.         leisure.  If you try out a program and discover, "this program is 
  335.         junk",  then  you  are not out $29.95.   You  simply  delete  the 
  336.         program.   No  money lost - what a deal.   Ah,  but if you  find, 
  337.         "Hey,  this program is really good,  I think I'll use it!", then, 
  338.         if  you play by the rules,  you are asked to send a small fee  to 
  339.         cover the cost of developing the program.  Not a bad deal.  
  340.  
  341.              If you find Zippy DIR to be a useful program,  and you would 
  342.         like  to see me write more quality programs,  then I ask that you 
  343.         register it for $ 5.00.   What do you get in return?  In addition 
  344.         to  having a very flexible directory program,  you get  peace  of 
  345.         mind,  knowing that you are supporting Shareware,  and helping to 
  346.         continue  it's  existence.   In addition,  when you register  and 
  347.         include your name and address,  I will notify you by mail of  the 
  348.         next  major upgrade (Version 2.00) of Zippy DIR,  including a BBS 
  349.         number where you can immediately download it.  See  "future plans 
  350.         for ZDIR" for further information.
  351.  
  352.              To register Zippy DIR,  print out the ZDIR.REG file and fill 
  353.         it out,  or write your name,  address and name of program you are 
  354.         registering  on  a sheet of paper,  along with  any  comments  or 
  355.         suggestions,  and  send cash,  check or money order for $ 5.00 to 
  356.         the following address : 
  357.  
  358.  
  359.                                 Ray Johns 
  360.                                 Box 1440
  361.                                 Pebble Beach, CA. 
  362.                                 93953-1440
  363.  
  364.  
  365.  
  366.                                         4
  367.  
  368.  
  369.  
  370.  
  371.                         - Why another DIR replacement ? -
  372.  
  373.  
  374.              Probably  one of the most common Shareware programs  is  the 
  375.         "DIR replacement" program.   So why, you ask, did I spend my time 
  376.         writing  another one?   Well,  when it came right down to  it,  I 
  377.         couldn't  find a DIR replacement program that I liked better than 
  378.         the plain old DIR command in DOS.   Don't get me wrong, there are 
  379.         plenty  of good directory type programs,  but I have  found  that 
  380.         most  of them are either too slow,  or are of the "load and sort" 
  381.         variety.  That's fine, but usually I just want to quickly look at 
  382.         my  directory.  I don't want it sorted and I don't want  to  wait 
  383.         while  it's loaded.   So for years,  I just stuck with plain  old 
  384.         DIR.   The  more  times I used DIR,  the more times I thought  to 
  385.         myself,  why  didn't  "they" put this in DIR,  or  that  in  DIR.  
  386.         Finally,  I  wrote  my own!   Zippy DIR represents my efforts  to 
  387.         write a very easy to use, yet very powerful directory replacement 
  388.         program.  I think that once you use Zippy DIR a few times, you'll 
  389.         never go back to using plain old DIR again. 
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                                         5
  428.  
  429.  
  430.  
  431.  
  432.                                 - Installation -
  433.  
  434.  
  435.              First  thing you need to do is put ZDIR.COM in a pathed  sub 
  436.         directory.   If you aren't clear what a path is or does, refer to 
  437.         your  DOS manual.   For anyone who has "lost" their  DOS  manual, 
  438.         following is a brief explanation of the path command. 
  439.  
  440.              As  you may know,  if you try to access a file,  or program, 
  441.         which is not in the same directory as you are currently  in,  DOS 
  442.         will not find it.  If you setup a path to the directory where the 
  443.         program  you wish to access is,  then DOS will find it no  matter 
  444.         where  you  currently are.   To see if you already have  a  path, 
  445.         simply  type the word PATH and hit ENTER at the DOS  prompt.   If 
  446.         you  do  have  a  path,  copy  ZDIR.COM to any  one  of  the  sub 
  447.         directories  listed in your path.   If you find that you  do  not 
  448.         have  a path,  you must create one.   First select a directory to 
  449.         put ZDIR.COM in,  most any will do,  something along the lines of 
  450.         "\DOS" or "\UTIL" is fine.   For example,  if you select  "\DOS", 
  451.         you  would copy ZDIR.COM to \DOS,  and add the following line  to 
  452.         your AUTOEXEC.BAT file :
  453.                       
  454.                                   PATH = \DOS
  455.  
  456.              This can be done with any text editor or word processor.  If 
  457.         you  do  not have an AUTOEXEC.BAT file,  just create one in  your 
  458.         root directory.   Now anytime you turn on your computer, you will 
  459.         be  able to see your directory by entering ZDIR,  just  like  you 
  460.         could by entering DIR.
  461.  
  462.              During  the testing of ZDIR.COM,  a few of the Beta  testers 
  463.         found  it useful to rename ZDIR.COM to ZD.COM or even  Z.COM,  so 
  464.         they didn't have to type so much.  Feel free to do this, but when 
  465.         you distribute the program, please leave the name as ZDIR.COM.  I 
  466.         should  also point out that if you rename ZDIR.COM to DIR.COM  it 
  467.         won't run, as DOS will search in the COMMAND.COM file first, thus 
  468.         finding  it's own DIR command and ignoring DIR.COM.   There is  a 
  469.         way around this problem,  however,  because it requires modifying 
  470.         copyrighted software (ie COMMAND.COM), I can not cover it in this 
  471.         document.
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                         6
  489.  
  490.  
  491.  
  492.  
  493.                              - Command line format -
  494.  
  495.  
  496.              The command line for Zippy DIR is as follows :
  497.  
  498.  
  499.                        ZDIR [d:][Path\][Filemask][/Switch]
  500.  
  501.              All the information inside of [..] is optional,  and  breaks 
  502.         down in the following manner :   (Do NOT type the [] characters.)
  503.  
  504.              
  505.         [d:] - Drive Name
  506.  
  507.              This  tells ZDIR what drive to look on.   If  omitted,  ZDIR 
  508.         will  look on the current drive you are logged to.   For example, 
  509.         to do a directory of your floppy drive you would enter "ZDIR  A:"  
  510.         Any  drive from A:  to Z:  may be entered,  however you will  get 
  511.         "Drive  d:  invalid"  if  it is not a valid drive  name  in  your 
  512.         system.   The  name  of  the  drive can be before  or  after  the 
  513.         [Path\][Filemask] section of the command line.   This can come in 
  514.         particularly  handy  if you first do a directory of  the  default 
  515.         drive  (ie  no drive supplied) and then want to  check  a  second 
  516.         drive.   All  you have to do is pop up the last command line with 
  517.         the F3 key and add the name of the drive to the end of the line.
  518.  
  519.  
  520.         [Path\] - Directory path name
  521.  
  522.              This tells ZDIR where to look for files.   If omitted,  ZDIR 
  523.         will look in the current sub directory of the drive (set with the 
  524.         CD command.)  If the Path\ given is invalid, you will get a "Path 
  525.         not  found"  error message.   Any valid path name  is  supported, 
  526.         including path names with dot extensions.   One thing you  should 
  527.         note  about the way directory path names are handled in Zippy DIR 
  528.         is,  unlike the DIR command in DOS,  ZDIR, does not automatically 
  529.         "expand"  or  "look into" sub  directories.   For  example,  with 
  530.         standard  DIR,  if you have a sub directory called \UTIL and  you 
  531.         enter  DIR \UTIL,  you will see the contents of \UTIL,  not  just 
  532.         that UTIL is a directory.   In some cases,  this can be annoying, 
  533.         in other cases, it can save you typing an extra "\".  In ZDIR, if 
  534.         you enter ZDIR \UTIL, it will not show you the contents of \UTIL.  
  535.         To  see  the files in the \UTIL sub directory you need  to  enter 
  536.         ZDIR \UTIL\.   Just remember,  in ZDIR to see what is inside of a 
  537.         sub  directory ALL PATH NAMES MUST END WITH A SLASH  "\".   Don't 
  538.         worry,  it isn't as big a deal as you may be thinking it is.  The 
  539.         only  stipulation  on where the Path\ can appear on  the  command 
  540.         line is, if you supply a filemask, the path\ MUST come before the 
  541.         filemask.
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                                         7
  550.  
  551.  
  552.  
  553.  
  554.         [Filemask] - File name or string to search for
  555.  
  556.              In  the  Filemask section of the command line,  two  of  the 
  557.         major uses of Zippy DIR are realized.   Not only does it  support 
  558.         any  format which is allowable in DOS (refer to your DOS manual), 
  559.         but  it supports two formats which are not supported by  DOS  (ie 
  560.         DIR).  As mentioned under "Features of ZDIR", ZDIR supports, what 
  561.         I  am  calling (because no other program I know of  supports  it) 
  562.         "Reverse  wildcards."  As you probably know,  a wildcard is a "?" 
  563.         or an "*".   The "?" can be substituted for any character in  the 
  564.         filename  (mask)  and  DOS will return files  regardless  of  the 
  565.         character in that (the "?") position.   Likewise, the "*" means a 
  566.         group of characters.   However,  in DIR this group can ONLY be at 
  567.         the end of a filename.  The filename "ZD*.*" will return any file 
  568.         with  ZD  as the first two letters followed by any amount of  any 
  569.         letters after that.   A very handy function to say the least.  So 
  570.         why  can't you say "*ES.*" to show you any filename  ending  with 
  571.         "ES" and having any amount of any letters before that?   For some 
  572.         reason  DOS  chose to leave this option out.   I have put  it  in 
  573.         ZDIR.   You can now group your files,  or find them, with reverse 
  574.         wildcards  as well as normal wildcards.   Note that this wildcard 
  575.         function is only supported on the filename and not the  extension 
  576.         of the file.      
  577.  
  578.              The  other  major use or capability of Zippy DIR,  is to  do 
  579.         text  string searches within a filename.   Referred to as  "Zippy 
  580.         Scans",  this  function  will  find an occurrence  for  a  string 
  581.         anywhere  in the filename or the extension of  a  filename.   For 
  582.         example,  if  you have a file in a specific sub directory and you 
  583.         can  only remember that it has the word "SETUP" in it,  then  you 
  584.         can  enter  "SETUP" as the filemask and Zippy DIR  will  begin  a 
  585.         zippy  scan for "SETUP" anywhere in the filename.   This can free 
  586.         you  from having to remember every single letter of  a  filename.  
  587.         Now  you  can just remember a few "key" letters,  and then  do  a 
  588.         zippy search.  This function alone will make your life much, much 
  589.         easier, I promise!
  590.  
  591.              Keep  this in mind,  when Zippy DIR looks at a filemask,  it 
  592.         assumes it to be a text string (zippy) search.  If you enter ZDIR 
  593.         QMODEM,  ZDIR will search for 'QMODEM'.  If all you really wanted 
  594.         in  that case was to see any filename called QMODEM  ending  with 
  595.         any  extension,  then  you need to enter ZDIR QMODEM.*  All  this 
  596.         really isn't as hard as I'm making it out to be,  just use common 
  597.         sense when it comes to filenames and extensions,  the best way to 
  598.         learn Zippy DIR is to play with it for a while.
  599.  
  600.              Note,  if  the filemask is omitted,  all files are shown  by 
  601.         default.
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.                                         8
  611.  
  612.  
  613.  
  614.  
  615.         [/Switch] - One or more program switches
  616.  
  617.              If omitted, the program works in it's default configuration.  
  618.         Any number of valid switches may be entered on the command  line.  
  619.         They  can be at the beginning or the end of the command line,  in 
  620.         fact they can be just about anywhere.   If you enter a  duplicate 
  621.         or  an unsupported switch you will receive the error message "Bad 
  622.         /  Duplicate Switch."  Following are the main  program  switches.  
  623.         Note  that  in  the  "Customizing ZDIR"  section  there  is  also 
  624.         information  on  what  are called "override"  switches,  but  for 
  625.         anyone  using  ZDIR  in it's unmodified state,  they  are  of  no 
  626.         real importance.  
  627.  
  628.  
  629.         /H - display internal program Help  
  630.  
  631.              This  switch will show you a sort of "Quick Reference"  menu 
  632.         or help screen of commands and information.  Turn on your printer 
  633.         when  you do this to print out a handy reference card.   Entering 
  634.         "/?" will also display this help screen.
  635.  
  636.  
  637.         /N - only show Non executable files 
  638.  
  639.              From  time  to  time,  you find yourself looking  at  a  sub 
  640.         directory  with large numbers of .COM and .EXE or .BAT files  and 
  641.         only  a few actual "data" files or files that you are  interested 
  642.         in.   By including the "/N" switch,  Zippy DIR will show only Non 
  643.         executable files,  any file which doesn't end with .BAT,  .COM or 
  644.  
  645.  
  646.         /P - Pause after each screen full of information 
  647.  
  648.              I  included this switch to be compatible with  the  standard 
  649.         DIR  format.   By entering /P the screen will pause every time it 
  650.         is filled with information.   Pushing any key will continue until 
  651.         the next screen full.
  652.  
  653.  
  654.         /W - show files in Wide (five across) mode
  655.  
  656.              This switch is here,  you guessed it,  to be compatible with 
  657.         DIR and because it's a handy option.   By including /W,  you  can 
  658.         see just the filenames, five wide.
  659.  
  660.  
  661.         /X - only show eXecutable files 
  662.  
  663.              This  switch  does  the  opposite  of  the  /N  switch.   By 
  664.         including  it on the command line,  Zippy DIR will show you  only 
  665.         files ending in .BAT, .COM or .EXE (ie any file you can "run").  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.                                         9
  672.  
  673.  
  674.  
  675.  
  676.                                 - Function keys - 
  677.  
  678.  
  679.              Zippy  DIR supports a number of "function keys."  These keys 
  680.         may be pressed anytime ZDIR is displaying information (ie  before 
  681.         it  returns  to the DOS prompt.)  All the function keys  work  at 
  682.         anytime,  including  after or what would seem to be "during"  the 
  683.         function of another key.  Following is a list of keys you can use 
  684.         to control the way ZDIR displays information : 
  685.  
  686.  
  687.         SPACEBAR - Single step display
  688.  
  689.              While  information is being displayed,  pushing the spacebar 
  690.         will  begin/continue "single stepping."  This means  the  program 
  691.         will  display one line each time you hit the  spacebar.   Holding 
  692.         down the spacebar will allow you to cruise through your directory 
  693.         at a pace equal to your key repeat rate.
  694.  
  695.  
  696.         ENTER - Pause / Resume display
  697.  
  698.              Pushing the ENTER key while the program is displaying files, 
  699.         will pause the display,  once it is paused, either with the ENTER 
  700.         key  or another function,  pushing this key again will resume the 
  701.         display.
  702.  
  703.  
  704.         TAB - Toggle display modes
  705.  
  706.              This  function  key at first may seem pretty  darn  useless, 
  707.         however,  the more you use it, the more you may find you like it.  
  708.         All  it  does is allow you to switch between the  normal  display 
  709.         mode  and  the wide (five across) display mode,  and  back  again 
  710.         while information is being displayed.  Try it.
  711.  
  712.  
  713.         BACKSPACE - Restart display from the top
  714.  
  715.              How  many times have you seen the file you were looking  for 
  716.         go  flying off the top of the screen ????   When this happens  in 
  717.         ZDIR, pushing the backspace key will restart the display of files 
  718.         from the beginning.
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                                        10
  733.  
  734.  
  735.  
  736.  
  737.         ESCAPE - Terminate Zippy DIR
  738.  
  739.              If  you are sick of trying to find Ctrl-Break or  Ctrl-C  to 
  740.         stop  the standard DIR command,  you'll love this.  Just hit  the 
  741.         escape key and you are back at the DOS prompt.  
  742.  
  743.  
  744.         A-Z Keys - Begin first letter file searching 
  745.  
  746.              When  you are looking for a specific file in your  directory 
  747.         and  you know the first letter,  you can push that letter  before 
  748.         the  file  is  displayed,  and when Zippy DIR comes to  any  file 
  749.         starting with the letter you pressed,  it will pause.   The  scan 
  750.         letter can be cleared by pushing any other function key,  the "." 
  751.         key  works  well also.   During a first letter scan,  the  letter 
  752.         being  scanned  for is displayed in the scan column  on  the  far 
  753.         right ("...") just after the file date & time.   Note that  first 
  754.         letter scans are also supported in the wide display mode, however 
  755.         the  scan letter is not displayed.   To continue scanning for the 
  756.         same  letter  after a match is found,  simply  push  that  letter 
  757.         again.
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                        11
  794.  
  795.  
  796.  
  797.  
  798.                                  - The display -  
  799.  
  800.  
  801.              Below is a sample output from Zippy DIR :
  802.  
  803.         ----------------------------------------------[ Video Display ]-
  804.         C:\DOS >
  805.         C:\DOS >ZDIR \mac\zd 
  806.  
  807.         Zippy DIR 1.00 - Copyright (c) 1988, Ray Johns
  808.  
  809.         Directory path - C:\MAC\*.*, 'ZD'
  810.  
  811.         ZDIR     ASM       56,320  .a..  Oct-10-88  07:06 am ...
  812.         ZDIR     COM        5,899  .a..  Oct-10-88  07:07 am ...
  813.         ZDIR     DOC       38,656  .a..  Oct-10-88  07:21 am ...
  814.  
  815.              3 Files      100,875  Bytes used by files
  816.                        12,566,528  Bytes free on disk 
  817.  
  818.         C:\DOS >
  819.         C:\DOS >
  820.         ----------------------------------------------------------------
  821.  
  822.  
  823.              Above  is  a sample of my development  directory.   In  this 
  824.         example,  ZDIR was searching for the string 'ZD' and found  three 
  825.         files having such a string.  After the copyright notice, you will 
  826.         see the "Directory path - " line,  to the right of this will be : 
  827.         The drive,  path,  and filemask being used by Zippy DIR including 
  828.         any  zippy  scan text in '' and any other pertinent  information.  
  829.         On the following line, the filename and extension is shown.  Next 
  830.         to that the file size,  in bytes,  is shown with commas for  easy 
  831.         viewing.   Next  is the attribute field.   When no attributes are 
  832.         found  this will be "...." or when all attributes are found  this 
  833.         will be "rash" (Read only,  Archive,  System,  Hidden).   To  the 
  834.         right  of the attribute field is the date and time (stamp) of the 
  835.         file.   The final field is the "first letter search" field.  When 
  836.         searching  for a filename by the first letter,  the letter  being 
  837.         searched for will appear in place of the second of the three dots 
  838.         "..."  in  lower case.   For example,  ".a." means Zippy  DIR  is 
  839.         searching for any filename starting with the letter "A".
  840.  
  841.              After  all files are displayed,  Zippy DIR will  return  the 
  842.         number  of matching files,  the bytes used by only those matching 
  843.         files,  and the space remaining on the drive.   If,  for example, 
  844.         you  are  wondering how much space a specific group of  files  is 
  845.         using  in your directory,  simply do a Zippy DIR of them and  the 
  846.         number of bytes used by the files will be displayed at the end of 
  847.         the directory.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                        12
  855.  
  856.  
  857.  
  858.  
  859.                             - Future plans for ZDIR - 
  860.  
  861.                             
  862.              Zippy DIR Version 1.00 is a complete program.   To the  best 
  863.         of  my knowledge there are no bugs in it.   I hope that you  find 
  864.         ZDIR to be a valuable program and will support the growth of both 
  865.         Zippy  DIR and shareware by registering it.   If the response  to 
  866.         Zippy  DIR  is  good,  I will continue plans  for  Version  2.00.  
  867.         Although  the exact release date is has not been set,  here are a 
  868.         few  of  the  features  I am planning  on  adding.   If  you  see 
  869.         something  listed that you would enjoy having in  Zippy  DIR,  or 
  870.         something  not listed,  please make a note of it on the  ZDIR.REG 
  871.         form.  I value your suggestions about my shareware very highly.
  872.  
  873.  
  874.                  Features Planed for Version 2.00 of Zippy DIR :  
  875.  
  876.                        (Subject to change without notice) 
  877.  
  878.  
  879.         o   A sort directory option.   This will be a FAST sort, not 
  880.             the kind that takes all day just to sort a 1000 files.  
  881.  
  882.         o   A  "Brief"  display  mode,  to compliment the  wide  and 
  883.             normal  display modes.   This will list  only  filename, 
  884.             extension,  file size and attribute,  excluding the date 
  885.             and time stamp.  The result will be a faster display.   
  886.  
  887.         o   The  ability  to  pass a filename to  a  user  definable 
  888.             program with a specific function key.   For example, you 
  889.             could  pause  at a text file and by pushing  a  function 
  890.             key,  invoke  your favorite "file view" utility or  word 
  891.             processor  with file already loaded,  then exit back  to 
  892.             Zippy DIR.
  893.  
  894.         o   A  Global drive search option.   This would allow  Zippy 
  895.             DIR to act as a "Where is" program including the ability 
  896.             to search for reverse wildcards and text strings  within 
  897.             filenames in any sub directory.
  898.  
  899.         o   A   user   definable  "show  only  files   with   theses 
  900.             extensions" switch.
  901.  
  902.         o   The  ability to do a directory inside of an archive type 
  903.             file.  This will be compatible with the archive standard 
  904.             of the day.  (Phil Katz we are waiting on ya... (grin))
  905.  
  906.         o   An easy to use setup type program to change the  default 
  907.             configuration of Zippy DIR.
  908.  
  909.  
  910.                         **  Register Zippy DIR today!  **
  911.  
  912.  
  913.  
  914.  
  915.                                        13
  916.  
  917.  
  918.  
  919.  
  920.                           - Contacting me about ZDIR -
  921.  
  922.  
  923.              If  you have any questions,  comments,  or suggestions about 
  924.         Zippy DIR,  or experience any problems using it,  you are welcome 
  925.         to contact me at one of the two following BBS number.   I am  the 
  926.         remote sysop at the first number, and I call the second number at 
  927.         least once a day.  I will be more than happy to discuss Zippy DIR 
  928.         or  any of my shareware with you.   I am logged on both boards as  
  929.         "RAY JOHNS."
  930.  
  931.  
  932.         The SURF BBS in Monterey,  California.  Phone (408) 649-6148.  Up 
  933.         24  hours  a  day,  7  days  a  week,  running  WildCat  software 
  934.         supporting both 300 and 1200 baud.   Sysops :  Harry Johnson, Ray 
  935.         Johns, and Eric Magnus.
  936.  
  937.         The Cricket BBS in Pacific Grove,  California.   Phone (408) 373-
  938.         3773.   Two  nodes.   Up 24 hours a day,  7 days a  week  running 
  939.         PCBoard supporting 1200 and 2400 baud.  Sysop : Jim Robeson.
  940.  
  941.  
  942.              Along  with  the two boards listed above,  you can find  the 
  943.         most  current  version of any of my Shareware  at  the  following 
  944.         "Distribution BBS numbers."
  945.  
  946.  
  947.                      The Courier Connection - (602) 971-2454
  948.                      Computer Connections   - (202) 547-2008
  949.                      VOR-BBS                - (707) 778-8944 
  950.  
  951.  
  952.              You are also welcome to write  me at the following  address, 
  953.         if  you  are  not a registered user and require a  reply,  please 
  954.         include a SASE.
  955.  
  956.  
  957.                                   Ray Johns
  958.                                   Box 1440
  959.                                   Pebble Beach, CA. 
  960.                                   93953-1440
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.                                        14
  977.  
  978.  
  979.  
  980.  
  981.                               - Customizing ZDIR - 
  982.  
  983.  
  984.              This section is intended for anyone who wishes to modify the 
  985.         default  settings of Zippy DIR.   For example,  if you have  very 
  986.         fast  screen  I/O and would like ZDIR to default  to  /P  without 
  987.         having  to supply /P on the command line,  this section will tell 
  988.         you what bytes can be changed and what they control.   If you are 
  989.         not planning on changing ZDIR's defaults, skip past this section.
  990.  
  991.              First,  before  you begin modifying ZDIR's  internal  flags, 
  992.         understand  that  when distributing Zippy DIR,  you are asked  to 
  993.         distribute only the non-modified version.   PLEASE KEEP A  NORMAL 
  994.         COPY FOR THAT PURPOSE.   File offsets are listed in memory load / 
  995.         debug address format.  If you are using a sector editor to do the 
  996.         changes  subtract  100 hex from all addresses,  this will be  the 
  997.         "file  offset" needed for such editors.   In ZDIR.COM,  you  will 
  998.         find the following table at memory offset 0340 hex,  it will look 
  999.         something like this :
  1000.  
  1001.  
  1002.     0340  55 53 45 52 20 50 61 74-63 68 20 54 61 62 6C 65   USER Patch Table       
  1003.     0350  2D 2D 2D 2D 2D 2D 2D 2D-2D 2D 2D 2D 2D 2D 2D 2D   ----------------
  1004.     0360 +00 2D 20 2F 4E 20 66 6C-61 67 20 30 31 3D 4F 6E   .- /N flag 01=On
  1005.     0370 +00 2D 20 2F 50 20 66 6C-61 67 20 30 31 3D 4F 6E   .- /P flag 01=On
  1006.     0380 +00 2D 20 2F 57 20 66 6C-61 67 20 30 31 3D 4F 6E   .- /W flag 01=On
  1007.     0390 +00 2D 20 2F 58 20 66 6C-61 67 20 30 31 3D 4F 6E   .- /X flag 01=On
  1008.     03A0 +18 2D 20 2F 50 20 23 20-6F 66 20 6C 69 6E 65 73   .- /P # of lines
  1009.     03B0 +05 2D 20 2F 57 20 23 20-6F 66 20 66 69 6C 65 73   .- /W # of files
  1010.     03C0 +00 2D 20 53 74 65 70 70-69 6E 67 20 66 6C 61 67   .- Stepping flag
  1011.     03D0  2D 2D 2D 2D 2D 2D 2D 2D-2D 2D 2D 2D 2D 2D 2D 2D   ----------------
  1012.     03E0  20 45 6E 64 20 6F 66 20-50 61 74 63 68 65 73 20    End of Patches 
  1013.  
  1014.                   User patchable bytes are shown here with "+"            
  1015.  
  1016.              With any flag byte,  00 hex means off, 01 hex means on.  For 
  1017.         example  to enable /P by default,  change the zero at offset 0370 
  1018.         hex  to  01 hex.   The last three user patchable  bytes  are  for 
  1019.         Number of lines to pause after, Number of files to show across in 
  1020.         wide mode, and stepping mode enabled.  The number of lines for /P 
  1021.         and  files  for /W are in hex.   The stepping flag works  in  the 
  1022.         following  manner  :  00 hex equals "free flow" display  (ie  the 
  1023.         normal  default),  when the user pushes the space bar,  signaling 
  1024.         "single step mode" this byte is changed to 01 hex.   If you enter 
  1025.         01  hex  here (offset 03C0 hex),  Zippy DIR will come up  in  the 
  1026.         single step mode by default and only show one line, then pause.  
  1027.  
  1028.         After  changing the program defaults,  you may need to use  these 
  1029.         "override" switches from time to time :
  1030.  
  1031.         /A - All files.  Overrides /N and /X
  1032.         /C - Continuous display.  Overrides /P when doing ^P or >OUTFILE 
  1033.         /L - Long display mode.  Overrides /W    
  1034.  
  1035.  
  1036.  
  1037.                                        15
  1038.  
  1039.  
  1040.  
  1041.  
  1042.                              - Miscellaneous Notes -
  1043.  
  1044.  
  1045.         ERRORLEVEL information :
  1046.  
  1047.              If  you  are  calling ZDIR.COM from a  Batch  language  file 
  1048.         (.BAT),  you  will be happy to know that Zippy DIR returns  error 
  1049.         codes according to how it executed.   Following is a list of  the 
  1050.         ERRORLEVEL numbers (E#) and their descriptions relative to ZDIR :
  1051.  
  1052.  
  1053.         E# - Description with regard to Zippy DIR
  1054.         --   ------------------------------------------------------------
  1055.          0 - No error, program finished or was terminated normally.
  1056.          2 - File specified was not found.
  1057.          3 - Path specified was not found.
  1058.         11 - Command line was invalid, Bad switch for example.
  1059.         15 - A drive was specified that was not valid in the system.
  1060.         --   ------------------------------------------------------------
  1061.  
  1062.  
  1063.         Source code information :
  1064.  
  1065.              Allow though the source code for my first shareware  program 
  1066.         is available,  the source code for Zippy DIR is not.  If you have 
  1067.         a question relating to the source code,  I'll be happy to try and 
  1068.         answer  it on one of the two BBS numbers listed in this document.  
  1069.         If you are a software developer and would be interested in having 
  1070.         the  reverse wildcard and Zippy scan functions in your  Shareware 
  1071.         program  or utility,  the code to do this is available in  return 
  1072.         for twenty five dollars and a note in your .DOC file about  where 
  1073.         it  came  from.   The routine to parse the command line  is  very 
  1074.         intelligent  and took over 30 hours to develop.  It is  available 
  1075.         and  could save you MANY hours of programming as well as adding a 
  1076.         whole new dimension of power to your command line.
  1077.  
  1078.  
  1079.         Hardware and OS bundling agreements :
  1080.  
  1081.              I would be more than happy to discuss the use of ZDIR.COM in 
  1082.         any Hardware or Operation System package.   Contact me at my  BBS 
  1083.         (listed  in  this  document) and I will supply you with  a  voice 
  1084.         phone number or further information.
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.                                        16
  1099.  
  1100.  
  1101.  
  1102.  
  1103.                               - Revision history -
  1104.  
  1105.  
  1106.         October 10th, 1988 - Initial release of Version 1.00.
  1107.  
  1108.         Note : If any bugs are found, the corrected copy will be released 
  1109.         under Version 1.01, 1.02, etc.
  1110.  
  1111.  
  1112.                               - Acknowledgements -
  1113.  
  1114.  
  1115.              I  would  like to thanks all the people involved  with  Beta 
  1116.         testing Zippy DIR and giving me suggestions for it.  THANK YOU!
  1117.  
  1118.  
  1119.                        David Dilworth    Jim Robeson     
  1120.                        George Layton     Karl Van Lear   
  1121.                        Harry Johnson     Marty White     
  1122.                        Henry Paes        Paul Ricketts   
  1123.                        Jeff Watkins      Philip Childress
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.                                - End of Document -
  1156.  
  1157.  
  1158.  
  1159.                                        17